home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / vista / readme < prev   
Text File  |  1992-01-16  |  5KB  |  136 lines
  1. To build Vista:
  2.         
  3.           [ Vista is built using the GNU software
  4.         bison and flex (similar to the Unix
  5.         utilities yacc and lex).  If theye are
  6.         not installed on your system, install
  7.         them from the directories Bison and 
  8.         Flex first.  They are used in building
  9.         libae.a (in ./src/lib/ae), and that 
  10.         Makefile may need to be changed to 
  11.         reflect the path name to these two
  12.         utilities. ]
  13.  
  14.     Make sure that the MAKE variables described below are set
  15.     properly in at least the Makefile in this directory.
  16.     The values set in this directory should propagate down to 
  17.     the subdirectories.
  18.  
  19.     Then, type make.  This should build the libraries and binary
  20.     files needed for Vista.  The directories are contents after
  21.     the makefile should be something like this, though the file
  22.     sizes may vary due to system differences:
  23.  
  24.         ./bin:
  25.         total 1928
  26.         -rwxr-xr-x  1 username   114688 Sep 16 19:08 ae_dm
  27.         -rwxr-xr-x  1 username  1630208 Sep 16 19:08 vista
  28.         -rwxr-xr-x  1 username   106496 Sep 16 19:08 vm_dm
  29.  
  30.         ./lib:
  31.         total 896
  32.         -r--r--r--  1 username   689488 Sep 16 19:04 libvista.a
  33.     
  34.     The binary files are executed from this directory.  If you
  35.     move them elsewhere, the variable V_BIN described below
  36.     must be changed before building Vista to reflect their eventual
  37.     destination.
  38.  
  39.     The directory ./data is used as distributed.  You may wish to
  40.     move the entire directory elsewhere. if so, be sure to change
  41.     V_DATA described below.
  42.  
  43.     The X Resource Manager application defaults file for Vista is
  44.     in the data directory.  This should be copied to
  45.         /usr/lib/X11/app-defaults/Vista
  46.     or some other appropriate place on your system.
  47.  
  48. To run Vista:
  49.     Two example programs have been provided: whams3d, a finite
  50.     element code and jac2, a one-sided Jacobi method (iterative
  51.     eigenvalue method).  Change to the directory ./example and
  52.     then to either jac or wham.  Type make to make the application.
  53.  
  54.     If the application defaults file has NOT been installed yet,
  55.     then you must make this information available to the X
  56.     resource manager in one of two other ways:
  57.  
  58.        1. Copy the application defaults file to ~/app-defaults/Vista
  59.           and set the environment variable XAPPLRESDIR to ~/app-defaults.
  60.         or
  61.        2. Set the environment variable XENVIRONMENT to the full path
  62.           name of the file whereever you have it.  Probably in
  63.           the directory of the MAKE variable V_DATA described below.
  64.           For example, ${VISTA_TOP}/data/Vista.
  65.  
  66.     Normally, Vista (the visualization manager) is run on the local
  67.     workstation.  Just execute the program .../bin/vista (whatever
  68.     the full path name is).  The application is run in a rlogin
  69.     window (remote login shell) on another system.  After the Vista
  70.     display appears, start the application in this other window.
  71.     (To do this type whams3d.s or jac2, depending on the example).
  72.     After several seconds you should see the message:
  73.         "Received connection from <remote host>"
  74.     in the Vista status window.  You are now ready to add variables
  75.     to Vista and display them as desired.
  76.  
  77.     Unless variables have been added with Vista "insert" calls
  78.     (like CALL AV2I(...)), they will be named with the routine
  79.     name, two accents and the variable name.  For example, in 
  80.     jac2, the variable of interest is hybr01``vv to view the
  81.     2-dimensional array solution.
  82.  
  83.     In whams3d, interesting variables to add are (case is significant):
  84.         NTSTEP        - time step
  85.         XC, YC, ZC    - the X, Y, and Z coordinate arrays
  86.         xdisp, ydisp, zdisp - the X, Y, and Z displacement arrays
  87.         NNODE        - number of nodes
  88.         NELE        - number of elements
  89.         kdvcon        - element connectivity array
  90.     remember also to toggle the "row major"/"column major" state.
  91.  
  92.  
  93. Make Variables:
  94.     Make sure that the following variables are set in the Makefile
  95.     in this directory.  These are propageted to the sub-directories.
  96.     These are used in the installation and also may compile into the
  97.     Vista modules for default path names to some files.
  98.     Only the VISTA_TOP and possibly X/MOTIF variables must be changed.
  99.     The others will have reasonable defaults enabling you to build Vista.
  100.  
  101.     VISTA_TOP =      set to this directory; top level for Vista
  102.                THIS MUST BE SET TO AN ABSOLUTE PATHNAME
  103.     V_BIN     =     path to the installed binaries for the
  104.             modules of Vista
  105.                Default: ${VISTA_TOP}/bin
  106.     V_DATA     =     path to the data files Vista uses during
  107.             execution.  E.g., public color maps, pixmaps, etc.
  108.                Default: ${VISTA_TOP}/data
  109.  
  110. The next variables should need no change, they are only used for installation
  111.  
  112.     V_LIB     =     path to the libraries used to build Vista
  113.                Default: ${VISTA_TOP}/lib 
  114.     V_INC     =     path to the include files used to build Vista
  115.                Default: ${VISTA_TOP}/include
  116.     V_CFLAGS =    flags passed to cc.  E.g. -g 
  117.                Default: -D_NO_PROTO -D_VFORK -DVersionDate=
  118.             
  119.     The -D_NO_PROTO is required since many C compilers do not handle
  120.     ANSI C Function prototypes.  Vista is written without prototypes,
  121.     and the X11/Motif include files need to know this.
  122.  
  123.     The -D_VFORK will use VFORK instead of FORK where possible
  124.     (e.g., Berkeley 4.2-derived systems).  It's only purpose is
  125.     to save a bit of resources.  If your system does not support
  126.     VFORK, then just remove this define.
  127.  
  128.     The -DVersionDate compiles the date into each module for identifing
  129.     different versions.
  130.  
  131. These are the libraries to search for the X11, Release 4 
  132. and Motif libraries.
  133.  
  134.     X_LIB    =    -lXt -lX11
  135.     MOTIF_LIB=    -lXm
  136.